home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Amiga Magazin: Amiga-CD 1997 November & December
/
Amiga-CD 1997 #11-12.iso
/
pd-disketten
/
ungepackt
/
12_95
/
apd-12-95-4-2
/
superprint
/
superprint.doc
< prev
next >
Wrap
Text File
|
1996-01-25
|
16KB
|
426 lines
SuperPrint
------------
THE LUXUS PRINT-UTILITY
description to version 3.5b
17 June 1994
PD-Giftware
(german and english version)
----------------------------------------------------------------------
-- SuperPrint requires OS-2.04 or higher. --
-- It was depeloped under OS-3.0 --
----------------------------------------------------------------------
SUPERPRINT description
------------------------
SuperPrint is a helpful utility for printing ASCII-things like
documents or sourcecodes. Well, this work could also be done with the
DOS-command 'TYPE', but is TYPE able to
- number pages?
- define edges?
- handle oversized lines?
- print own information on each page?
- handle headers and footers?
- create a table of contents?
Nes!!
The edges can be defined via PREFS, well, but there the whole thing
ends!
However, the maincause for my work was, that I wanted to print the
description to 'TERM' and I found some print tool in my PD-collection.
But the description for TERM is realy long, so I didn't realize lines
with overlength.
Result: The page-layout (headers and footers) was totally disturbed,
because this tool didn't handle this.
(And so here a call to all programmers and docu-writers: please keep
the linelength in your projects within 70 chars, but never longer than
79 chars! As you can see, this manual also keeps this form.)
So I wrote my own program, Intuition-frontend, OS-2.0 Functions, which
I want to describe now (well, I have to, at the moment I'm the only
one knowing all features).
New since version 3.0 is the automatic Table Of Contents. Therefor it
have to be an additional file for each manual containing all headlines
for the Table.
After starting the program an information is shown to you for a
short time while SuperPrint gets initialized. Then it is replaced with
the mainwindow.
The Mainwindow
----------------
Different gadgets appears (buttons, strings, cycles):
FILENAME ...... An ASL-Filerequester appears, so you can choose the
file you want to print.
In the string-gadget right to the button the name of
the file can be edited by hand.
If a 'TableOfContents'-File (later more) is found it
is told you via requester and you can choose to use
it. It's senseful, but it takes a little time (realy
just a little!) The main- is also an appwindow, so you
can put the icon of the file you want to print into
the SuperPrintWindow.
SCAN FILE ..... This function checks the choosen file for the max.
linelength and counts the needed pages. The results
will be displayed in the two boxes right to the
SCAN-Button. If the SCAN-Function is activated in the
Options-Window (later more) a small message gives you
detailed information about formfeeds, number of pages,
number of lines and some more.
LEFT MARGIN ... Here you can enter the number of blanks between the
left paperedge and the beginning of the text
RIGHT MARGIN .. Here you can enter the charposition where the line
ends. You can take the real length of the lines out
of the box 'Chars/Line'.
LINES/PAGE .... Here you can enter the number of the max. possible
lines on a page.
<- PREFS ...... With these three buttons right to the inputfields the
program automatically uses the default values given by
the system-preferences.
HEADLINES ..... Here you can enter the number of lines for the header
(from the lines/page-number).
BOTTOM ........ here you can enter the number of lines for the footer
(in its kind the same like HEADLINES).
EXTRA TEXT .... here you can enter a special text appearing on each
page in the header or the footer (later more)
HEADER ........ The first cycle-gadget is for selecting the style of
the header on each page (plain, bold or italic)
The second gadget is for selecting the contents of the
header: its either 'empty', shows the 'pagenumber' or
the 'Extra text'.
Therefor the header should be at least one line large.
FOOTER ........ These cyclegadgets are similar to the HEADER-Gadgets,
but not for the header, they're (I think you guess it)
for the footer.
PRINT IT ...... Starts printing. A small control-window appears
showing you what's going on. And you can even cancel
the thing.
If there should also be printed a TableOfContents,
the file is scanned twice and so the controlwindow
appears twice, but you can't abort the first scan.
OPTIONS ....... opens a second window with more settings to do (later
more)
PROGRAM-INFO .. shows an information around the program
EXIT .......... To make it short: the program executes without any
comment and without keeping the settings (only if
saved before via options-window) the same function
as if you use the close-gadget of the window, the
program terminates itself. Well, this EXIT-Button is
absolutely horrible, but commodore requires that
function.
Values behind the remarks
PAGES .............. Number of pages from the selected file (only
valid after scanning)
MAX. CHARS/LINE .... maximal number of chars per line for the selected
file (only valid after scanning)
CHARS/LINE ......... the effective length of a line using the edges
LINES/PAGE ......... shows you the number of printable lines per page
between the header and the footer.
The OPTIONS-Window
--------------------
Here you can edit not-so-often changed settings. Most of the functions
are handled by CYCLE-Gadgets.
MORE CHARS .... If a line is longer than defined via edges, it can be
choosen what have to be done with the rest of this
line. 'Cut off' means that these chars will be not
printed, 'print...' prints this chars, but this could
derange the layout! 'Split' will devide the original
line into more lines of the set length.
FORMFEED ...... Some files contain 'formfeed'. Well, that's a
wunderful thing if the writers kept the form.
But if not......YOU have SuperPrint, and with this
function you can tell SuperPrint to ignore those
formfeeds ('ignore') or to use them ('notice').
IGNORE is usefull, if a file contains Formfeeds, but
they're not placed very well (caused by this headers
and footers).
CPI ........... If a file contains realy long lines (more than 80
chars) and you need them, you can switch to a higher
CPI (the higher the CPI, the more chars can be printed
in one line)
QUALTITY ...... Here you can choose the art of printing, 'Letter' for
LetterQuality, 'Draft' for a faster print.
PAGE TEXT ..... Here you can enter where to place the pagenumber,
'left', 'center' or 'right'.
TEXT (%N-NO) .. Here you can enter an additional text for the
pagenumber. '%N' stands for the pagenumber
SCAN INFO ..... Here you can turn on or off the extra-information by
SCAN. It shows you after a scan further infos about
the file (if there are formfeeds,....).
PRINT ......... This allows you to print the file on both sides of
you paper. Therefor you can first print the odd pages
and then the even pages - or print all pages in the
normal way.
SAVE .......... saves the current settings (also from the main-window)
in a file called 'SP.config' in the SuperPrint-Drawer.
The next call from Superprint automatically uses this
config then.
The program returns to the mainwindow
USE ........... The program returns to the mainwindow, the settings
will be used.
CANCEL ........ the programm returns to the mainwindow, the settings
before calling the OPTIONS-window will be used.
Interna
---------
All controlcodes in the choosen text will be used, but not the
formfeed, which is, just like you set it up, ignored or handled
internally (that means: the topical page will be ended, the footer
will be printed and a new page will be begon.
The edges are EVER measured in charth with the width of 10 cpi, the
extra text and the pagenumber are also printed in this width.
Since version 3.5 the font of the (Default)PublicScreen is used for
text-output. If the screen is to small for that text-output (gadgets,
etc.), the program uses automaticaly topaz 8 (wherever it fits).
Create a TableOfContents
--------------------------
Since version 3.0 to each manual a TableOfContents can be created.
Therefor it has to be an additional file to the manual with the same
name, but with the extension '.sprint'. This file contains all
headlines and further SuperPrint-settings.
The following keywords are realized:
LEFT= - sets the left Edge (like the gadget)
RIGHT= - same for the right edge
LINES= - sets the lines per page
HEAD= - sets the number of lines for the header
FOOT= - same for the footer
HEADMODE= - sets the text for the headers (0 - empty,
1 - pagenumber,
2 - extra-text)
FOOTMODE= - same for the footer
HEADSTYLE= - sets the kind of the headers (0 - plain,
1 - bold,
2 - italic)
FOOTSTYLE= - same for the footers
TEXT= - sets the extra-text
CPI= - set the CPI (0 - 10 CPI,
1 - 12 CPI,
2 - 17 CPI)
PAGEPOS= - sets the position of the page-text (0 - left,
1 - center,
2 - right)
ONE= - sets the number of lines printed before printing the
TableOfContents and then a new page will be begon.
INDEXHEAD= - sets the text, wich will be printed on the first page
of the TableOfContents.
STYLE= - sets the form of the headlines, at this time there are
BOLD for bold headlines and LEFT to move the headlines
one character left
@x= - here you can enter the headlines, x stands for further
definitions to the text: 0 - text is the same as in the
manual
1 - it's the begining of a
headline
2 - like 1, but the text is
copied from the manual
NOSORT= - Turns the alphabetic sort of the headlines off. The
sorting is made up by the pagenumbers.
As example there is a '.sprint'-file added to this manual.
APPEAL
--------
I beg all program- and textauthors to add a '.sprint' to their
productions. It is produced fast and raises the farsightedness of the
printings. And the manuals should not contain lines longer than 70
chars, because the rest of this lines will be cutted off or the
printing will be disturbed.
In the name of all users I thank you and as a programmer I'll accept
my rules, too.
Copyright, the Author
-----------------------
I think, this program is made up very well, it is not free from any
rights indeed, because some routines and procedures in this program
are used in other programs of mine, which are not public domain.
But they are my own procedures, so it doesn't matter!
But they are subjected to the (c) copyright from J. Schmitz [SOFT].
Since version 2.4 SuperPrint is giftware, it can be freely copied and
used. If you like this program and if you use it frequently, I would
be thankful for a little donation (something about 10,- DM).
Who can't treat oneself, I know that as an ex-student, should send a
small message to me (via snailmail, via Fido, via AmigaNet,...) with
suggestions and/or questions.
If you want, you can also send disks, own programs, good graphics,
samples or musicfiles instead of money.
Well, I bought myself an A4000 and my pockets are more than just empty
now, and so I'm glad for every donation (money, of cause or tips'n
tricks to the A4000 or something else).
(But you should better send those useful things like potatoesacks or
garden-mould to other people!)
The distribution on PD-Disks (-series) and on elecronical way for
SuperPrint is allowed and wished.
The price for a PD-Disk may not be higher than 6,- DM!! If you put the
program on a PD series disk send a copy of this disk to the author,
that's all you must do.
My Adress:
Juergen Schmitz
"PD"
Bergstrasse 82
56859 Bullay/Mosel
GERMANY
you can also find me in
FIDO: Juergen Schmitz, 2:2454/550.3
AMIGA-NET: Juergen Schmitz, 39:176/401.2
And before I forget it, but the following text must be, because
otherwise this program won't be free from rights:
Written with KICK-Pascal 2.0, MAXON-Computer GmbH.
And now - perfect print...
---------------------------------------------------------------------
SuperPrints History
---------------------------------------------------------------------
Version 3.5b: startup window opening changed
Version 3.5: GUI font sensitiv (thanks to program "Barney" ;-)
Version 3.4: BugFixes, address changed
Version 3.3: Bug in TabelOfContents printing removed
Version 3.2: New line-overlength handling (Split), print only odd
or even pages - NEW OPTIONS-FILE FORMAT!
Version 3.1.5:New command STYLE added
Version 3.1: 'TableOfContents' now not cogent alphabetic
Version 3.0: 'TableOfContents'-generator included
Version 2.4: Some bugs removed (footer on last page was printed in
the wrong style) Better texts, SuperPrint is now
GIFTWARE. SuperPrint now uses the system-default-font if
possible
Version 2.3b: Bug in the in V2.3 changed printfunction removed
(lines >80 Zeichen were ever cutted),
Notices by SCAN-function adjusted and added
Version 2.3: SCAN-function implemented, 'lines/page'-field added,
the english doc removed, because to old and no time for
a new. AmigaGuide-File added
Version 2.2: new functions, options-window for further settings,
save-option, the handling of the edges changed
Version 2.1: beta-version to 2.2
Version 2.0: now with WB-AppWindow, so Icons can be dropped in the
window
Version 1.9: bugs removed, SCAN FILE now with 'Abort'
Version 1.8: new function SCAN FILE, optics changed, better handling
from ESC-Codes
Version 1.7: no changes, but now available in english
Version 1.6: first public release, only german
---------------------------------------------------------------------
English description done by Matthias Wege, added and updated by
myself.
JS/06